home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat2 / standard / sigstack.z / sigstack
Text File  |  1998-10-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSIIIIGGGGSSSSTTTTAAAACCCCKKKK((((2222))))                                                        SSSSIIIIGGGGSSSSTTTTAAAACCCCKKKK((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sigstack - set and/or get signal stack context
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  13.  
  14.      ssssttttrrrruuuucccctttt ssssiiiiggggssssttttaaaacccckkkk {{{{
  15.           ccccaaaaddddddddrrrr____tttt   ssssssss____sssspppp;;;;
  16.           iiiinnnntttt  ssssssss____oooonnnnssssttttaaaacccckkkk;;;;
  17.      }}}};;;;
  18.  
  19.      ssssiiiiggggssssttttaaaacccckkkk((((ssssssss,,,, oooossssssss))));;;;
  20.      ssssttttrrrruuuucccctttt ssssiiiiggggssssttttaaaacccckkkk ****ssssssss,,,, ****oooossssssss;;;;
  21.  
  22.      _S_i_g_s_t_a_c_k
  23.      is used in conjunction with sigvec(3b) which requires you to either
  24.  
  25.      1) #define
  26.         ____BBBBSSSSDDDD____SSSSIIIIGGGGNNNNAAAALLLLSSSS
  27.         or
  28.         ____BBBBSSSSDDDD____CCCCOOOOMMMMPPPPAAAATTTT
  29.         before including <_s_i_g_n_a_l._h>,
  30.         or
  31.  
  32.      2) specify one of them in the compile
  33.         command or makefile:
  34.  
  35.           cc -D_BSD_SIGNALS -o prog prog.c
  36.  
  37.  
  38. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.      _S_i_g_s_t_a_c_k allows users to define an alternate stack on which signals are
  40.      to be processed.  If _s_s is non-zero, it specifies a _s_i_g_n_a_l _s_t_a_c_k on which
  41.      to deliver signals and tells the system if the process is currently
  42.      executing on that stack.  When a signal's action indicates its handler
  43.      should execute on the signal stack (specified with a _s_i_g_v_e_c(3b) call),
  44.      the system checks to see if the process is currently executing on that
  45.      stack.  If the process is not currently executing on the signal stack,
  46.      the system arranges a switch to the signal stack for the duration of the
  47.      signal handler's execution. If _o_s_s is non-zero, the current signal stack
  48.      state is returned.
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      Signal stacks are not ``grown'' automatically, as is done for the normal
  52.      stack.  If the stack overflows unpredictable results may occur.
  53.  
  54. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  55.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  56.      of -1 is returned and _e_r_r_n_o is set to indicate the error.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSIIIIGGGGSSSSTTTTAAAACCCCKKKK((((2222))))                                                        SSSSIIIIGGGGSSSSTTTTAAAACCCCKKKK((((2222))))
  71.  
  72.  
  73.  
  74. EEEERRRRRRRROOOORRRRSSSS
  75.      _S_i_g_s_t_a_c_k will fail and the signal stack context will remain unchanged if
  76.      one of the following occurs.
  77.  
  78.      [EFAULT]       Either _s_s or _o_s_s points to memory that is not a valid part
  79.                     of the process address space.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      sigvec(3b), setjmp(3)
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.